# 사설 패키지 저장소

## 개요

**사 패키지 저장소**(Private Repository)는 조직 개인이 소프트어 개발 과정에서 사용하는 패키지(라이브러리, 모듈 등) 내부적으로 저장·관리하고 배포하기 위한 전용 저장소를 의미합니다. 공개된 패키지 저장소(예: npm, PyPI, Maven Central 등)와 달리, 사설 저장소는 내부 네트워크나 보안이 강화된 환경에서 운영되며, 접근 권한을 제한함으로써 민감한 코드나 기업 내부용 라이브러리를 안전하게 관리할 수 있습니다.

사설 패키지 저장소는 대규모 소프트웨어 개발 프로젝트, 기업용 애플리케이션 개발, DevOps 환경에서 중요한 역할을 하며, 코드 재사용성 향상, 배포 자동화, 보안 강화, 네트워크 의존도 감소 등의 장점을 제공합니다.

---

## 필요성과 목적

### 1. 보안성 강화
공개 저장소에 민감한 내부 라이브러리나 비즈니스 로직을 포함한 패키지를 업로드할 경우, 정보 유출 위험이 존재합니다. 사설 저장소는 접근 제어(Access Control) 기능을 통해 인증된 사용자나 시스템만 패키지에 접근할 수 있도록 하여 보안을 확보합니다.

### 2. 네트워크 안정성 및 속도 향상
외부 공개 저장소에 의존하면 네트워크 지연, 다운타임, 지역적 접근 제한 등의 문제가 발생할 수 있습니다. 사설 저장소를 내부 네트워크에 구축하면 빠르고 안정적인 패키지 다운로드가 가능하며, 특히 CI/CD 파이프라인에서 빌드 시간을 단축할 수 있습니다.

### 3. 커스터마이징 및 정책 관리
조직은 사설 저장소를 통해 자체적인 버전 관리 정책, 승인 프로세스, 감사 로그 등을 설정할 수 있습니다. 예를 들어, 특정 패키지는 보안 검토 후에만 배포를 허용하는 등의 정책을 적용할 수 있습니다.

### 4. 오프라인 환경 지원
격리된 네트워크(에어갭 환경)에서 개발하거나 운영하는 경우, 외부 인터넷 접근이 불가능하므로 사설 저장소는 필수적입니다. 미리 동기화된 패키지를 내부에서 제공함으로써 개발 및 배포를 지속할 수 있습니다.

---

## 주요 구축 방식

### 1. 프록시 저장소 (Proxy Repository)
외부 공개 저장소(예: npmjs.com, pypi.org)의 패키지를 캐시하는 방식입니다. 내부 사용자가 외부 패키지를 요청하면 사설 저장소가 이를 프록시로 받아 캐시하고, 이후 동일한 요청은 캐시된 버전을 제공합니다.

- **장점**: 외부 저장소에 대한 접근을 단일 지점으로 통제 가능, 외부 네트워크 사용량 감소
- **사례**: Nexus Repository Manager, Artifactory

### 2. 호스팅 저장소 (Hosted Repository)
조직 내부에서 개발한 패키지만을 저장하고 배포하는 전용 저장소입니다. 내부 팀이 개발한 라이브러리, 프레임워크 등을 업로드하여 공유할 수 있습니다.

- **장점**: 완전한 제어권 확보, 내부 IP 보호
- **사용 사례**: 회사 고유 유틸리티 라이브러리, 비즈니스 도메인 모듈

### 3. 그룹 저장소 (Group Repository)
여러 저장소(프록시, 호스팅 등)를 하나의 논리적 저장소로 묶어 제공하는 방식입니다. 사용자는 단일 URL로 내부 패키지와 외부 패키지 모두에 접근할 수 있습니다.

- **예**: `npm install` 시 그룹 저장소를 지정하면 내부 패키지는 호스팅 저장소에서, 외부 패키지는 프록시 저장소를 통해 해결

---

## 대표적인 사설 저장소 도구

| 도구명 | 지원 패키지 매니저 | 특징 |
|--------|--------------------|------|
| **JFrog Artifactory** | npm, Maven, PyPI, Docker, Helm 등 | 다수의 패키지 형식 지원, 강력한 보안 기능, CI/CD 통합 우수 |
| **Sonatype Nexus Repository** | npm, Maven, NuGet, PyPI 등 | 오픈소스 버전 존재, 확장성 높음, 기업용 라이선스 제공 |
| **Verdaccio** | npm, yarn 등 Node.js 생태계 | 가볍고 설치 쉬움, 오픈소스, 소규모 팀에 적합 |
| **PyPI Server (pypiserver)** | Python (PyPI) | 간단한 Python 패키지 호스팅용, 파일 기반 저장 |
| **GitLab Package Registry** | 다양한 형식 지원 | GitLab과 통합, CI/CD 파이프라인과 시너지 효과 |

---

## 구축 시 고려 사항

1. **접근 제어 및 인증**
   - LDAP/Active Directory 연동
   - OAuth, API 키 기반 인증
   - 역할 기반 접근 제어(RBAC)

2. **백업 및 재해 복구**
   - 정기적인 저장소 백업
   - 복제(replication) 기능을 통한 고가용성 구축

3. **모니터링 및 로깅**
   - 패키지 다운로드/업로드 로그
   - 접근 실패 감지
   - 용량 사용 현황 모니터링

4. **버전 관리 및 정책**
   - 패키지 삭제 제한
   - 레거시 버전 보관 전략
   - 자동 만료 정책

5. **CI/CD 통합**
   - Jenkins, GitHub Actions, GitLab CI 등과의 연동
   - 빌드 시 자동 배포 및 테스트

---

## 활용 사례

- **대기업 소프트웨어 팀**: 수십 개의 마이크로서비스에서 공통으로 사용하는 내부 라이브러리를 사설 npm 저장소에 배포하여 일관성 유지
- **금융기관**: 외부 네트워크 차단 환경에서 사설 PyPI 저장소를 통해 데이터 분석 패키지 관리
- **게임 개발사**: Unity 에셋과 커스텀 툴을 사설 NuGet 저장소로 관리하여 개발자 간 공유

---

## 참고 자료 및 관련 문서

- [JFrog Artifactory 공식 문서](https://www.jfrog.com/confluence/display/JFROG/Welcome+to+JFrog+Artifactory)
- [Sonatype Nexus Repository 사용 가이드](https://help.sonatype.com/repomanager3)
- [Verdaccio GitHub 저장소](https://github.com/verdaccio/verdaccio)
- [Python Packaging User Guide - Private PyPI](https://packaging.python.org/guides/hosting-your-own-index/)
- [DevOps 도구 체인에서의 패키지 관리 전략](https://devops.com/package-management-in-devops-pipelines/)

사설 패키지 저장소는 현대 소프트웨어 개발 인프라의 핵심 요소로, 보안, 효율성, 안정성 측면에서 필수적인 역할을 수행합니다. 조직의 규모와 요구사항에 맞는 저장소 솔루션을 선택하고 철저히 관리하는 것이 성공적인 소프트웨어 개발 환경을 만드는 데 기여합니다.